IRIX 6.5 Complementary Applications 2004 February

home *** CD-ROM | disk | FTP | other *** search

/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmFileSelectionBox.z.z / XmFileSelectionBox.z / XmFileSelectionBox

Wrap

Text File | 2003-11-18 | 58.6 KB | 1,189 lines

XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) NNNNAAAAMMMMEEEE _X_m_F_i_l_e_S_e_l_e_c_t_i_o_n_B_o_x - The FileSelectionBox widget class SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS #include <Xm/FileSB.h> DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN FileSelectionBox traverses through directories, views the files and subdirectories in them, and then selects files. A FileSelectionBox has the following main areas: +o A text input field for displaying and editing a directory mask used to select the files to be displayed +o An optional text input field for displaying and editing a filter mask used to select the files to be displayed. +o A scrollable list of filenames +o A scrollable list of subdirectories +o A text input field for displaying and editing a filename +o A group of PushButtons, labeled _O_K, _F_i_l_t_e_r, _C_a_n_c_e_l, and _H_e_l_p Additional children may be added to the FileSelectionBox after creation. FileSelectionBox inherits the layout functionality provided by SelectionBox for any additional children. The list of filenames, the list of subdirectories, or both can be removed from the FileSelectionBox after creation by unmanaging the appropriate widgets and their labels. The list and label widgets are obtained by calling the function _X_m_F_i_l_e_S_e_l_e_c_t_i_o_n_B_o_x_G_e_t_C_h_i_l_d. To remove either the directory list or the file list, unmanage the parent of the appropriate list widget and unmanage the corresponding label. The user can specify resources in a resource file for the automatically created widgets and gadgets of FileSelectionBox. The following list identifies the names of these widgets (or gadgets) and the associated FileSelectionBox areas. Filter Label - "FilterLabel" Filter Text - "Text" Directory List - "DirList" Page 1 (printed 11/11/03) XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) Directory List Label - "Dir" The directory mask is a string specifying the base directory to be examined and a search pattern. Ordinarily, the directory list displays the subdirectories of the base directory, as well as the base directory itself and its parent directory. The file list ordinarily displays all files and/or subdirectories in the base directory that match the search pattern. Optionally, the search pattern mask and the base directory can be displayed in two separate text fields. This option is controlled by the _p_a_t_h_M_o_d_e resource. Having two text fields for the search pattern mask and the directory makes it easier for the end user to edit and understand these two separate concepts. Using this alternate display does not change the meaning of resources that control the content of these fields: XmNdirectory, XmNdirMask, and XmNpattern. A procedure specified by the _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c resource extracts the base directory and search pattern from the directory mask. If the directory specification is empty, the current working directory is used. If the search pattern is empty, a pattern that matches all files is used. An application can supply its own _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c as well as its own procedures to search for subdirectories and files. The default _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c works as follows: The directory mask is a pathname that can contain zero or more wwwwiiiillllddddccccaaaarrrrdddd characters in its directory portion, its file portion, or both. The directory components of the directory mask up to, but not including, the first component with a wildcard character specify the directory to be searched, relative to the current working directory. The remaining components specify the search pattern. If the directory mask is empty or if its first component contains a wildcard character, the current working directory is searched. If no component of the directory mask contains a wildcard character, the entire directory mask is the directory specification, and all files in that directory are matched. The user can select a new directory to examine by scrolling through the list of directories and selecting the desired directory or by editing the directory mask. Selecting a new directory from the directory list does not change the search pattern. A user can select a new search pattern by editing the directory mask or, when the FileSelectionBox has the optional _p_a_t_h_M_o_d_e XmPATH_MODE_RELATIVE display, the filter text field. Double clicking or pressing _K_A_c_t_i_v_a_t_e on a directory in the directory list initiates a search for files and subdirectories in the new directory, using the current Page 2 (printed 11/11/03) XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) search pattern. The user can select a file by scrolling through the list of filenames and selecting the desired file or by entering the filename directly into the text edit area. Selecting a file from the list causes that filename to appear in the file selection text edit area. The user may select a new file as many times as desired. The application is not notified until the user takes one of these actions: +o Selects the _O_K PushButton +o Presses _K_A_c_t_i_v_a_t_e while the selection text edit area has the keyboard focus. +o Double clicks or presses _K_A_c_t_i_v_a_t_e on an item in the file list FileSelectionBox initiates a directory and file search when any of the following occurs: +o The FileSelectionBox is initialized +o The function _X_t_S_e_t_V_a_l_u_e_s is used to change _X_m_N_d_i_r_M_a_s_k, _X_m_N_d_i_r_e_c_t_o_r_y, _X_m_N_p_a_t_t_e_r_n, or _X_m_N_f_i_l_e_T_y_p_e_M_a_s_k +o The user activates the _F_i_l_t_e_r PushButton +o The user double clicks or presses _K_A_c_t_i_v_a_t_e on an item in the directory list +o The application calls _X_m_F_i_l_e_S_e_l_e_c_t_i_o_n_D_o_S_e_a_r_c_h +o The user presses _K_A_c_t_i_v_a_t_e while the directory mask text edit area has the keyboard focus When a file search is initiated, the FileSelectionBox takes the following actions: +o Constructs an _X_m_F_i_l_e_S_e_l_e_c_t_i_o_n_B_o_x_C_a_l_l_b_a_c_k_S_t_r_u_c_t structure with values appropriate for the action that initiated the search +o Calls the _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c with the callback structure as the data input argument +o Sets _X_m_N_d_i_r_e_c_t_o_r_y_V_a_l_i_d and _X_m_N_l_i_s_t_U_p_d_a_t_e_d to False +o Calls the _X_m_N_d_i_r_S_e_a_r_c_h_P_r_o_c with the qualified data returned by the _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c Page 3 (printed 11/11/03) XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) If _X_m_N_d_i_r_e_c_t_o_r_y_V_a_l_i_d is True, the FileSelectionBox takes these additional actions: +o Sets _X_m_N_l_i_s_t_U_p_d_a_t_e_d to False +o Calls the _X_m_N_f_i_l_e_S_e_a_r_c_h_P_r_o_c with the qualified data returned by the _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c (and possibly modified by the _X_m_N_d_i_r_S_e_a_r_c_h_P_r_o_c) +o If _X_m_N_l_i_s_t_U_p_d_a_t_e_d is True and the file list is empty, displays the _X_m_N_n_o_M_a_t_c_h_S_t_r_i_n_g in the file list and clears the selection text and _X_m_N_d_i_r_S_p_e_c +o If _X_m_N_l_i_s_t_U_p_d_a_t_e_d is True and the file list is not empty, sets the selection text and _X_m_N_d_i_r_S_p_e_c to the qualified ddddiiiirrrr returned by the _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c (and possibly modified by the _X_m_N_d_i_r_S_e_a_r_c_h_P_r_o_c) +o Sets the directory mask text and _X_m_N_d_i_r_M_a_s_k to the qualified mmmmaaaasssskkkk returned by the _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c (and possibly modified by the _X_m_N_d_i_r_S_e_a_r_c_h_P_r_o_c) +o Sets _X_m_N_d_i_r_e_c_t_o_r_y to the qualified ddddiiiirrrr returned by the _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c (and possibly modified by the _X_m_N_d_i_r_S_e_a_r_c_h_P_r_o_c) +o Sets _X_m_N_p_a_t_t_e_r_n to the qualified ppppaaaatttttttteeeerrrrnnnn returned by the _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c (and possibly modified by the _X_m_N_d_i_r_S_e_a_r_c_h_P_r_o_c) CCCCllllaaaasssssssseeeessss FileSelectionBox inherits behavior and resources from _C_o_r_e, _C_o_m_p_o_s_i_t_e, _C_o_n_s_t_r_a_i_n_t, _X_m_M_a_n_a_g_e_r, _X_m_B_u_l_l_e_t_i_n_B_o_a_r_d, and _X_m_S_e_l_e_c_t_i_o_n_B_o_x. The class pointer is _x_m_F_i_l_e_S_e_l_e_c_t_i_o_n_B_o_x_W_i_d_g_e_t_C_l_a_s_s. The class name is _X_m_F_i_l_e_S_e_l_e_c_t_i_o_n_B_o_x. NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in a .Xdefaults file, remove the _X_m_N or _X_m_C prefix and use the remaining letters. To specify one of the defined values for a resource in a .Xdefaults file, remove the _X_m prefix and use the remaining letters (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate if the given resource can be set at creation time (C), set by using _X_t_S_e_t_V_a_l_u_e_s (S), retrieved by using _X_t_G_e_t_V_a_l_u_e_s (G), or is Page 4 (printed 11/11/03) XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) not applicable (N/A). XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss _____________________________________________________________________________________________________ XmNdirectory XmCDirectory XmString dynamic CSG XmNdirectoryValid XmCDirectoryValid Boolean dynamic SG XmNdirListItems XmCDirListItems XmStringTable dynamic SG XmNdirListItemCount XmCDirListItemCount int dynamic SG XmNdirListLabelString XmCDirListLabelString XmString dynamic CSG XmNdirMask XmCDirMask XmString dynamic CSG XmNdirSearchProc XmCDirSearchProc XmSearchProc default procedure CSG XmNdirSpec XmCDirSpec XmString dynamic CSG XmNfileListItems XmCItems XmStringTable dynamic SG XmNfileListItemCount XmCItemCount int dynamic SG XmNfileListLabelString XmCFileListLabelString XmString dynamic CSG XmNfileSearchProc XmCFileSearchProc XmSearchProc default procedure CSG XmNfileTypeMask XmCFileTypeMask unsigned char XmFILE_REGULAR CSG XmNfilterLabelString XmCFilterLabelString XmString dynamic CSG XmNlistUpdated XmCListUpdated Boolean dynamic SG XmNnoMatchString XmCNoMatchString XmString " [ ] " CSG XmNpattern XmCPattern XmString dynamic CSG XmNqualifySearchDataProc XmCQualifySearchDataProc XmQualifyProc default procedure CSG pathMode PathMode XmRPathMode XmPATH_MODE_FULL C fileFilterStyle FileFilterStyle XmRFileFilterStyle XmFILTER_NONE C dirTextLabelString DirTextLabelString XmString NULL C _X_m_N_d_i_r_e_c_t_o_r_y Specifies the base directory used in combination with _X_m_N_p_a_t_t_e_r_n in determining the files and directories to be displayed. The default value is determined by the _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c and depends on the initial values of _X_m_N_d_i_r_M_a_s_k, _X_m_N_d_i_r_e_c_t_o_r_y, and _X_m_N_p_a_t_t_e_r_n. If the default is NULL or empty, the current working directory is used. _X_m_N_d_i_r_e_c_t_o_r_y_V_a_l_i_d Specifies an attribute that is set only by the directory search procedure. The value is set to True if the directory passed to the directory search procedure can actually be searched. If this value is False the file search procedure is not called, and _X_m_N_d_i_r_M_a_s_k, _X_m_N_d_i_r_e_c_t_o_r_y, and _X_m_N_p_a_t_t_e_r_n are not changed. _X_m_N_d_i_r_L_i_s_t_I_t_e_m_s Specifies the items in the directory list. _X_t_G_e_t_V_a_l_u_e_s for this resource returns the list items themselves, not a copy of the list items. The application must not free the returned items. Page 5 (printed 11/11/03) XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) _X_m_N_d_i_r_L_i_s_t_I_t_e_m_C_o_u_n_t Specifies the number of items in the directory list. The value must not be negative. _X_m_N_d_i_r_L_i_s_t_L_a_b_e_l_S_t_r_i_n_g Specifies the label string of the directory list. The default for this resource depends on the locale. In the C locale the default is "Directories". _X_m_N_d_i_r_M_a_s_k Specifies the directory mask used in determining the files and directories to be displayed. The default value is determined by the _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c and depends on the initial values of _X_m_N_d_i_r_M_a_s_k, _X_m_N_d_i_r_e_c_t_o_r_y, and _X_m_N_p_a_t_t_e_r_n. _X_m_N_d_i_r_S_e_a_r_c_h_P_r_o_c Specifies a directory search procedure to replace the default directory-search procedure. FileSelectionBox's default directory-search procedure fulfills the needs of most applications. Because it is impossible to cover the requirements of all applications, you can replace the default search procedure. The directory search procedure is called with two arguments: the FileSelectionBox widget and a pointer to an _X_m_F_i_l_e_S_e_l_e_c_t_i_o_n_B_o_x_C_a_l_l_b_a_c_k_S_t_r_u_c_t structure. The callback structure is generated by the _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c and contains all information required to conduct a directory search, including the directory mask and a qualified base directory and search pattern. Once called, it is up to the search routine to generate a new list of directories and update the FileSelectionBox widget by using _X_t_S_e_t_V_a_l_u_e_s. The search procedure must set _X_m_N_d_i_r_e_c_t_o_r_y_V_a_l_i_d and _X_m_N_l_i_s_t_U_p_d_a_t_e_d. If it generates a new list of directories, it must also set _X_m_N_d_i_r_L_i_s_t_I_t_e_m_s and _X_m_N_d_i_r_L_i_s_t_I_t_e_m_C_o_u_n_t. If the search procedure cannot search the specified directory, it must warn the user and set _X_m_N_d_i_r_e_c_t_o_r_y_V_a_l_i_d and _X_m_N_l_i_s_t_U_p_d_a_t_e_d to False, unless it prompts and subsequently obtains a valid directory. If the directory is valid but is the same as the current _X_m_N_d_i_r_e_c_t_o_r_y, the search procedure must set _X_m_N_d_i_r_e_c_t_o_r_y_V_a_l_i_d to True, but it may elect not to generate a new list of directories. In this case is must set _X_m_N_l_i_s_t_U_p_d_a_t_e_d to False. If the search procedure generates a new list of Page 6 (printed 11/11/03) XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) directories, it must set _X_m_N_d_i_r_L_i_s_t_I_t_e_m_s to the new list of directories and _X_m_N_d_i_r_L_i_s_t_I_t_e_m_C_o_u_n_t to the number of items in the list. If there are no directories, it sets _X_m_N_d_i_r_L_i_s_t_I_t_e_m_s to NULL and _X_m_N_d_i_r_L_i_s_t_I_t_e_m_C_o_u_n_t to 0. In either case it must set _X_m_N_d_i_r_e_c_t_o_r_y_V_a_l_i_d and _X_m_N_l_i_s_t_U_p_d_a_t_e_d to True. In constructing the list of directories, the search procedure should consider the value of the resource _f_i_l_e_F_i_l_t_e_r_S_t_y_l_e and exclude directories the begin with `.' when this resource is set to XmFILTER_HIDDEN_FILES. The search procedure ordinarily should not change the callback struct. But if the original directory is not valid, the search procedure may obtain a new directory from the user. In this case it should set the ddddiiiirrrr member of the callback struct to the new directory, call the _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c with the callback struct as the input argument, and copy the qualified data returned by the _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c into the callback struct. _X_m_N_d_i_r_S_p_e_c Specifies the full file path specification. This is the _X_m_N_t_e_x_t_S_t_r_i_n_g resource in SelectionBox, renamed for FileSelectionBox. The default value is determined by the FileSelectionBox after conducting the initial directory and file search. _d_i_r_T_e_x_t_L_a_b_e_l_S_t_r_i_n_g This resource takes effect when the _p_a_t_h_M_o_d_e is XmPATH_MODE_RELATIVE and is ignored when the _p_a_t_h_M_o_d_e is XmPATH_MODE_FULL. Specifies the label string of the directory text field. The default for this resource is NULL. _f_i_l_e_F_i_l_t_e_r_S_t_y_l_e There are two possible values: +o _0 / _X_m_F_I_L_T_E_R__N_O_N_E - the default _X_m_N_d_i_r_S_e_a_r_c_h_P_r_o_c and _X_m_N_f_i_l_e_S_e_a_r_c_h_P_r_o_c do not filter any of the directories or files. +o _1 / _X_m_F_I_L_T_E_R__H_I_D_D_E_N__F_I_L_E_S - the default _X_m_N_d_i_r_S_e_a_r_c_h_P_r_o_c and _X_m_N_f_i_l_e_S_e_a_r_c_h_P_r_o_c filter any file or directory that begins with `.'. There is one exception: the `..' directory is not filtered out of Page 7 (printed 11/11/03) XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) the directory search. _X_m_N_f_i_l_e_L_i_s_t_I_t_e_m_s Specifies the items in the file list. This is the _X_m_N_l_i_s_t_I_t_e_m_s resource in SelectionBox, renamed for FileSelectionBox. _X_t_G_e_t_V_a_l_u_e_s for this resource returns the list items themselves, not a copy of the list items. The application must not free the returned items. _X_m_N_f_i_l_e_L_i_s_t_I_t_e_m_C_o_u_n_t Specifies the number of items in the file list. This is the _X_m_N_l_i_s_t_I_t_e_m_C_o_u_n_t resource in SelectionBox, renamed for FileSelectionBox. The value must not be negative. _X_m_N_f_i_l_e_L_i_s_t_L_a_b_e_l_S_t_r_i_n_g Specifies the label string of the file list. This is the _X_m_N_l_i_s_t_L_a_b_e_l_S_t_r_i_n_g resource in SelectionBox, renamed for FileSelectionBox. The default for this resource depends on the locale. In the C locale the default is "Files". _X_m_N_f_i_l_e_S_e_a_r_c_h_P_r_o_c Specifies a file search procedure to replace the default file-search procedure. FileSelectionBox's default file-search procedure fulfills the needs of most applications. Because it is impossible to cover the requirements of all applications, you can replace the default search procedure. The file search procedure is called with two arguments: the FileSelectionBox widget and a pointer to an _X_m_F_i_l_e_S_e_l_e_c_t_i_o_n_B_o_x_C_a_l_l_b_a_c_k_S_t_r_u_c_t structure. The callback structure is generated by the _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c (and possibly modified by the _X_m_N_d_i_r_S_e_a_r_c_h_P_r_o_c). It contains all information required to conduct a file search, including the directory mask and a qualified base directory and search pattern. Once called, it is up to the search routine to generate a new list of files and update the FileSelectionBox widget by using _X_t_S_e_t_V_a_l_u_e_s. The search procedure must set _X_m_N_l_i_s_t_U_p_d_a_t_e_d. If it generates a new list of files, it must also set _X_m_N_f_i_l_e_L_i_s_t_I_t_e_m_s and _X_m_N_f_i_l_e_L_i_s_t_I_t_e_m_C_o_u_n_t. The search procedure is recommended always to generate a new list of files. If the mmmmaaaasssskkkk member of the callback struct is the same as the mmmmaaaasssskkkk member of the callback struct in the preceding call to the search procedure, the procedure may elect not to generate a Page 8 (printed 11/11/03) XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) new list of files. In this case it must set _X_m_N_l_i_s_t_U_p_d_a_t_e_d to False. If the search procedure generates a new list of files, it must set _X_m_N_f_i_l_e_L_i_s_t_I_t_e_m_s to the new list of files and _X_m_N_f_i_l_e_L_i_s_t_I_t_e_m_C_o_u_n_t to the number of items in the list. If there are no files, it sets _X_m_N_f_i_l_e_L_i_s_t_I_t_e_m_s to NULL and _X_m_N_f_i_l_e_L_i_s_t_I_t_e_m_C_o_u_n_t to 0. In either case it must set _X_m_N_l_i_s_t_U_p_d_a_t_e_d to True. In constructing the list of files, the search procedure should include only files of the types specified by the widget's _X_m_N_f_i_l_e_T_y_p_e_M_a_s_k. In constructing the list of files, the search procedure should consider the value of the resource _f_i_l_e_F_i_l_t_e_r_S_t_y_l_e and exclude files the begin with `.' when this resource is set to XmFILTER_HIDDEN_FILES. Setting _X_m_N_d_i_r_S_p_e_c is optional, but recommended. Set this attribute to the full file specification of the directory searched. The directory specification is displayed below the directory and file lists. _X_m_N_f_i_l_e_T_y_p_e_M_a_s_k Specifies the type of files listed in the file list. Following are the possible values: +o _X_m_F_I_L_E__R_E_G_U_L_A_R restricts the file list to contain only regular files. +o _X_m_F_I_L_E__D_I_R_E_C_T_O_R_Y restricts the file list to contain only directories. +o _X_m_F_I_L_E__A_N_Y__T_Y_P_E allows the list to contain all file types including directories. _X_m_N_f_i_l_t_e_r_L_a_b_e_l_S_t_r_i_n_g Specifies the label string for the text entry field for the directory mask. When the resource _p_a_t_h_M_o_d_e is XmPATH_MODE_RELATIVE, this string labels the text field entry for the pattern. The default for this resource depends on the locale. In the C locale the default is "Filter". _X_m_N_l_i_s_t_U_p_d_a_t_e_d Specifies an attribute that is set only by the directory and file search procedures. Set to True if the search procedure updated the directory or file list. _X_m_N_n_o_M_a_t_c_h_S_t_r_i_n_g Page 9 (printed 11/11/03) XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) Specifies a string to be displayed in the file list if the list of files is empty. _p_a_t_h_M_o_d_e This resource provides an alternate layout for the FileSelectionBox. It has two possible values: +o _0 / _X_m_P_A_T_H__M_O_D_E__F_U_L_L - a single text field to display the XmNdirMask. +o _1 / _X_m_P_A_T_H__M_O_D_E__R_E_L_A_T_I_V_E - a text field to display the XmNdirectory and a text field to display the XmNpattern. When the _p_a_t_h_M_o_d_e is XmPATH_MODE_RELATIVE, the resource _X_m_N_f_i_l_t_e_r_L_a_b_e_l_S_t_r_i_n_g applies to the text field for the _X_m_N_p_a_t_t_e_r_n, and the resource _d_i_r_T_e_x_t_L_a_b_e_l_S_t_r_i_n_g applies to the text field for the _X_m_N_d_i_r_e_c_t_o_r_y. _X_m_N_p_a_t_t_e_r_n Specifies the search pattern used in combination with _X_m_N_d_i_r_e_c_t_o_r_y in determining the files and directories to be displayed. The default value is determined by the _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c and depends on the initial values of _X_m_N_d_i_r_M_a_s_k, _X_m_N_d_i_r_e_c_t_o_r_y, and _X_m_N_p_a_t_t_e_r_n. If the default is NULL or empty, a pattern that matches all files is used. _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c Specifies a search data qualification procedure to replace the default data qualification procedure. FileSelectionBox's default data qualification procedure fulfills the needs of most applications. Because it is impossible to cover the requirements of all applications, you can replace the default procedure. The data qualification procedure is called to generate a qualified directory mask, base directory, and search pattern for use by the directory and file search procedures. It is called with three arguments: the FileSelectionBox widget and pointers to two _X_m_F_i_l_e_S_e_l_e_c_t_i_o_n_B_o_x_C_a_l_l_b_a_c_k_S_t_r_u_c_t structures. The first callback struct contains the input data. The second callback struct contains the output data, to be filled in by the data qualification procedure. If the input ddddiiiirrrr and ppppaaaatttttttteeeerrrrnnnn members are not NULL, the procedure must copy them to the corresponding members of the output callback struct. Page 10 (printed 11/11/03) XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) If the input ddddiiiirrrr is NULL, the procedure constructs the output ddddiiiirrrr as follows: If the input mmmmaaaasssskkkk member is NULL, the procedure uses the widget's _X_m_N_d_i_r_e_c_t_o_r_y as the output ddddiiiirrrr; otherwise, it extracts the output ddddiiiirrrr from the input mmmmaaaasssskkkk. If the resulting output ddddiiiirrrr is empty, the procedure uses the current working directory instead. If the input ppppaaaatttttttteeeerrrrnnnn is NULL, the procedure constructs the output ppppaaaatttttttteeeerrrrnnnn as follows: If the input mmmmaaaasssskkkk member is NULL, the procedure uses the widget's _X_m_N_p_a_t_t_e_r_n as the output ppppaaaatttttttteeeerrrrnnnn; otherwise, it extracts the output ppppaaaatttttttteeeerrrrnnnn from the input mmmmaaaasssskkkk. If the resulting output ppppaaaatttttttteeeerrrrnnnn is empty, the procedure uses a pattern that matches all files instead. The data qualification procedure constructs the output mmmmaaaasssskkkk from the output ddddiiiirrrr and ppppaaaatttttttteeeerrrrnnnn. The procedure must ensure that the output ddddiiiirrrr, ppppaaaatttttttteeeerrrrnnnn, and mmmmaaaasssskkkk are fully qualified. If the input vvvvaaaalllluuuueeee member is not NULL, the procedure must copy it to the output vvvvaaaalllluuuueeee member; otherwise, the procedure must copy the widget's _X_m_N_d_i_r_S_p_e_c to the output vvvvaaaalllluuuueeee. The data qualification procedure must calculate the lengths of the output vvvvaaaalllluuuueeee, mmmmaaaasssskkkk, ddddiiiirrrr, and ppppaaaatttttttteeeerrrrnnnn members and must fill in the corresponding length members of the output callback struct. The data qualification procedure must copy the input rrrreeeeaaaassssoooonnnn and eeeevvvveeeennnntttt members to the corresponding output members. The values of the _X_m_N_d_i_r_S_e_a_r_c_h_P_r_o_c and _X_m_N_f_i_l_e_S_e_a_r_c_h_P_r_o_c are procedure pointers of type _X_m_S_e_a_r_c_h_P_r_o_c, defined as follows: void (* XmSearchProc) (wwww,,,, sssseeeeaaaarrrrcccchhhh____ddddaaaattttaaaa) _W_i_d_g_e_t wwww; _X_t_P_o_i_n_t_e_rsssseeeeaaaarrrrcccchhhh____ddddaaaattttaaaa; wwww The FileSelectionBox widget sssseeeeaaaarrrrcccchhhh____ddddaaaattttaaaa Pointer to an _X_m_F_i_l_e_S_e_l_e_c_t_i_o_n_B_o_x_C_a_l_l_b_a_c_k_S_t_r_u_c_t containing information for conducting a search The value of the _X_m_N_q_u_a_l_i_f_y_S_e_a_r_c_h_D_a_t_a_P_r_o_c resource is a Page 11 (printed 11/11/03) XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) procedure pointer of type _X_m_Q_u_a_l_i_f_y_P_r_o_c, defined as follows: void (* XmQualifyProc) (wwww,,,, iiiinnnnppppuuuutttt____ddddaaaattttaaaa,,,, oooouuuuttttppppuuuutttt____ddddaaaattttaaaa) _W_i_d_g_e_t wwww; _X_t_P_o_i_n_t_e_riiiinnnnppppuuuutttt____ddddaaaattttaaaa; _X_t_P_o_i_n_t_e_roooouuuuttttppppuuuutttt____ddddaaaattttaaaa; wwww The FileSelectionBox widget iiiinnnnppppuuuutttt____ddddaaaattttaaaa Pointer to an _X_m_F_i_l_e_S_e_l_e_c_t_i_o_n_B_o_x_C_a_l_l_b_a_c_k_S_t_r_u_c_t containing input data to be qualified oooouuuuttttppppuuuutttt____ddddaaaattttaaaa Pointer to an _X_m_F_i_l_e_S_e_l_e_c_t_i_o_n_B_o_x_C_a_l_l_b_a_c_k_S_t_r_u_c_t containing output data to be filled in by the qualification procedure. IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss FileSelectionBox inherits behavior and resources from the following superclasses. For a complete description of each resource, refer to the man page for that superclass. XXXXmmmmSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss ______________________________________________________________________________________________________ XmNapplyCallback XmCCallback XtCallbackList NULL C XmNapplyLabelString XmCApplyLabelString XmString dynamic CSG XmNcancelCallback XmCCallback XtCallbackList NULL C XmNcancelLabelString XmCCancelLabelString XmString dynamic CSG XmNchildPlacement XmCChildPlacement unsigned char XmPLACE_ABOVE_SELECTION CSG XmNdialogType XmCDialogType unsigned char XmDIALOG_FILE_SELECTION G XmNhelpLabelString XmCHelpLabelString XmString dynamic CSG XmNlistItemCount XmCItemCount int dynamic CSG XmNlistItems XmCItems XmStringTable dynamic CSG XmNlistLabelString XmCListLabelString XmString dynamic CSG XmNlistVisibleItemCount XmCVisibleItemCount int dynamic CSG XmNminimizeButtons XmCMinimizeButtons Boolean False CSG XmNmustMatch XmCMustMatch Boolean False CSG XmNnoMatchCallback XmCCallback XtCallbackList NULL C XmNokCallback XmCCallback XtCallbackList NULL C XmNokLabelString XmCOkLabelString XmString dynamic CSG XmNselectionLabelString XmCSelectionLabelString XmString dynamic CSG XmNtextAccelerators XmCTextAccelerators XtAccelerators default C XmNtextColumns XmCColumns short dynamic CSG XmNtextString XmCTextString XmString dynamic CSG XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss Page 12 (printed 11/11/03) XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) __________________________________________________________________________________ XmNallowOverlap XmCAllowOverlap Boolean True CSG XmNautoUnmanage XmCAutoUnmanage Boolean False CG XmNbuttonFontList XmCButtonFontList XmFontList dynamic CSG XmNcancelButton XmCWidget Widget Cancel button SG XmNdefaultButton XmCWidget Widget OK button SG XmNdefaultPosition XmCDefaultPosition Boolean True CSG XmNdialogStyle XmCDialogStyle unsigned char dynamic CSG XmNdialogTitle XmCDialogTitle XmString NULL CSG XmNfocusCallback XmCCallback XtCallbackList NULL C XmNlabelFontList XmCLabelFontList XmFontList dynamic CSG XmNmapCallback XmCCallback XtCallbackList NULL C XmNmarginHeight XmCMarginHeight Dimension 10 CSG XmNmarginWidth XmCMarginWidth Dimension 10 CSG XmNnoResize XmCNoResize Boolean False CSG XmNresizePolicy XmCResizePolicy unsigned char XmRESIZE_ANY CSG XmNshadowType XmCShadowType unsigned char XmSHADOW_OUT CSG XmNtextFontList XmCTextFontList XmFontList dynamic CSG XmNtextTranslations XmCTranslations XtTranslations NULL C XmNunmapCallback XmCCallback XtCallbackList NULL C XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss _________________________________________________________________________________________________ XmNbottomShadowColor XmCBottomShadowColor Pixel dynamic CSG XmNbottomShadowPixmap XmCBottomShadowPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNforeground XmCForeground Pixel dynamic CSG XmNhelpCallback XmCCallback XtCallbackList NULL C XmNhighlightColor XmCHighlightColor Pixel dynamic CSG XmNhighlightPixmap XmCHighlightPixmap Pixmap dynamic CSG XmNinitialFocus XmCInitialFocus Widget dynamic CSG XmNnavigationType XmCNavigationType XmNavigationType XmTAB_GROUP CSG XmNshadowThickness XmCShadowThickness Dimension dynamic CSG XmNstringDirection XmCStringDirection XmStringDirection dynamic CG XmNtopShadowColor XmCTopShadowColor Pixel dynamic CSG XmNtopShadowPixmap XmCTopShadowPixmap Pixmap dynamic CSG XmNtraversalOn XmCTraversalOn Boolean True CSG XmNunitType XmCUnitType unsigned char dynamic CSG XmNuserData XmCUserData XtPointer NULL CSG CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss ______________________________________________________________________ XmNchildren XmCReadOnly WidgetList NULL G XmNinsertPosition XmCInsertPosition XtOrderProc NULL CSG XmNnumChildren XmCReadOnly Cardinal 0 G CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss Page 13 (printed 11/11/03) XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) ______________________________________________________________________________________________________________ XmNaccelerators XmCAccelerators XtAccelerators dynamic N/A XmNancestorSensitive XmCSensitive Boolean dynamic G XmNbackground XmCBackground Pixel dynamic CSG XmNbackgroundPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderColor XmCBorderColor Pixel XtDefaultForeground CSG XmNborderPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderWidth XmCBorderWidth Dimension 0 CSG XmNcolormap XmCColormap Colormap dynamic CG XmNdepth XmCDepth int dynamic CG XmNdestroyCallback XmCCallback XtCallbackList NULL C XmNheight XmCHeight Dimension dynamic CSG XmNinitialResourcesPersistent XmCInitialResourcesPersistent Boolean True C XmNmappedWhenManaged XmCMappedWhenManaged Boolean True CSG XmNscreen XmCScreen Screen * dynamic CG XmNsensitive XmCSensitive Boolean True CSG XmNtranslations XmCTranslations XtTranslations dynamic CSG XmNwidth XmCWidth Dimension dynamic CSG XmNx XmCPosition Position 0 CSG XmNy XmCPosition Position 0 CSG CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn A pointer to the following structure is passed to each callback: typedef struct { int rrrreeeeaaaassssoooonnnn; _X_E_v_e_n_t **** eeeevvvveeeennnntttt; _X_m_S_t_r_i_n_g vvvvaaaalllluuuueeee; _i_n_t lllleeeennnnggggtttthhhh; _X_m_S_t_r_i_n_g mmmmaaaasssskkkk; _i_n_t mmmmaaaasssskkkk____lllleeeennnnggggtttthhhh; _X_m_S_t_r_i_n_g ddddiiiirrrr; _i_n_t ddddiiiirrrr____lllleeeennnnggggtttthhhh; _X_m_S_t_r_i_n_g ppppaaaatttttttteeeerrrrnnnn; _i_n_t ppppaaaatttttttteeeerrrrnnnn____lllleeeennnnggggtttthhhh; } _X_m_F_i_l_e_S_e_l_e_c_t_i_o_n_B_o_x_C_a_l_l_b_a_c_k_S_t_r_u_c_t; rrrreeeeaaaassssoooonnnn Indicates why the callback was invoked eeeevvvveeeennnntttt Points to the _X_E_v_e_n_t that triggered the callback vvvvaaaalllluuuueeee Specifies the current value of _X_m_N_d_i_r_S_p_e_c lllleeeennnnggggtttthhhh Specifies the number of bytes in vvvvaaaalllluuuueeee mmmmaaaasssskkkk Specifies the current value of _X_m_N_d_i_r_M_a_s_k Page 14 (printed 11/11/03) XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) mmmmaaaasssskkkk____lllleeeennnnggggtttthhhh Specifies the number of bytes in mmmmaaaasssskkkk ddddiiiirrrr Specifies the current base directory ddddiiiirrrr____lllleeeennnnggggtttthhhh Specifies the number of bytes in ddddiiiirrrr ppppaaaatttttttteeeerrrrnnnn Specifies the current search pattern ppppaaaatttttttteeeerrrrnnnn____lllleeeennnnggggtttthhhh Specifies the number of bytes in ppppaaaatttttttteeeerrrrnnnn TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss XmFileSelectionBox inherits translations from XmSelectionBox. AAAAcccccccceeeelllleeeerrrraaaattttoooorrrrssss The _X_m_N_t_e_x_t_A_c_c_e_l_e_r_a_t_o_r_s from XmSelectionBox are added to the selection and directory mask (filter) Text descendants of XmFileSelectionBox. AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss The XmFileSelectionBox action routines are described below: _S_e_l_e_c_t_i_o_n_B_o_x_U_p_O_r_D_o_w_n(_0|_1|_2|_3): If neither the selection text nor the directory mask (filter) text has the focus, this action does nothing. If the selection text has the focus, the term lllliiiisssstttt in the following description refers to the file list, and the term tttteeeexxxxtttt refers to the selection text. If the directory mask text has the focus, lllliiiisssstttt refers to the directory list, and tttteeeexxxxtttt refers to the directory mask text. When called with a 0 argument, selects the previous item in the list and replaces the text with that item. When called with a 1 argument, selects the next item in the list and replaces the text with that item. When called with a 2 argument, selects the first item in the list and replaces the text with that item. When called with a 3 argument, selects the last item in the list and replaces the text with that item. _S_e_l_e_c_t_i_o_n_B_o_x_R_e_s_t_o_r_e(): If neither the selection text nor the directory mask (filter) text has the focus, this action does nothing. Page 15 (printed 11/11/03) XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) If the selection text has the focus, replaces the selection text with the selected item in the file list. If no item in the file list is selected, clears the selection text. If the directory mask text has the focus, replaces the directory mask text with a new directory mask constructed from the _X_m_N_d_i_r_e_c_t_o_r_y and _X_m_N_p_a_t_t_e_r_n resources. AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr The FileSelectionBox widget has the additional behavior described below: _M_A_n_y _K_C_a_n_c_e_l: Calls the activate callbacks for the cancel button if it is sensitive. If no cancel button exists and the parent of the FileSelectionBox is a manager, passes the event to the parent. <_K_A_c_t_i_v_a_t_e> in Selection Text: Calls the selection text widget's _X_m_N_a_c_t_i_v_a_t_e_C_a_l_l_b_a_c_k callbacks. If _X_m_N_m_u_s_t_M_a_t_c_h is True and the selection text does not match an item in the file list, calls the _X_m_N_n_o_M_a_t_c_h_C_a_l_l_b_a_c_k callbacks with reason _X_m_C_R__N_O__M_A_T_C_H. Otherwise, calls the _X_m_N_o_k_C_a_l_l_b_a_c_k callbacks with reason _X_m_C_R__O_K. <_K_A_c_t_i_v_a_t_e> in Directory Mask Text: Calls the directory mask text widget's _X_m_N_a_c_t_i_v_a_t_e_C_a_l_l_b_a_c_k callbacks. Initiates a directory and file search. Calls the _X_m_N_a_p_p_l_y_C_a_l_l_b_a_c_k callbacks with reason _X_m_C_R__A_P_P_L_Y. <_D_o_u_b_l_e_C_l_i_c_k> or <_K_A_c_t_i_v_a_t_e> in Directory List: Calls the directory list widget's _X_m_N_d_e_f_a_u_l_t_A_c_t_i_o_n_C_a_l_l_b_a_c_k callbacks. Initiates a directory and file search. Calls the _X_m_N_a_p_p_l_y_C_a_l_l_b_a_c_k callbacks with reason _X_m_C_R__A_P_P_L_Y. <_D_o_u_b_l_e_C_l_i_c_k> or <_K_A_c_t_i_v_a_t_e> in File List: Calls the file list widget's _X_m_N_d_e_f_a_u_l_t_A_c_t_i_o_n_C_a_l_l_b_a_c_k callbacks. Calls the _X_m_N_o_k_C_a_l_l_b_a_c_k callbacks with reason _X_m_C_R__O_K. <_S_i_n_g_l_e _S_e_l_e_c_t> or <_B_r_o_w_s_e _S_e_l_e_c_t> in Directory List: Generates a new directory mask, using the selected list item as the directory and the pattern extracted from the current directory mask text as the search pattern. If the search pattern is empty, uses a pattern that matches all files in the directory. Replaces the directory mask text with the new directory mask. Page 16 (printed 11/11/03) XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) <_S_i_n_g_l_e _S_e_l_e_c_t> or <_B_r_o_w_s_e _S_e_l_e_c_t> in File List: Replaces the selection text with the selected list item. <_B_D_r_a_g> in File List: Drags the content of one or more selected list items using the drag and drop facility. If _B_D_r_a_g is pressed on an unselected item, drags only that item, excluding any other selected items. The _X_m_N_e_x_p_o_r_t_T_a_r_g_e_t_s resource of the associated DragContext is set to target types of COMPOUND_TEXT and FILE_NAME. The _X_m_N_c_l_i_e_n_t_D_a_t_a resource is set to the index of the item in the list. <_B_D_r_a_g> in Directory List: Drags the content of one or more selected list items using the drag and drop facility. If _B_D_r_a_g is pressed on an unselected item, drags only that item, excluding any other selected items. The _X_m_N_e_x_p_o_r_t_T_a_r_g_e_t_s resource of the associated DragContext is set to target types of COMPOUND_TEXT and FILE_NAME. The _X_m_N_c_l_i_e_n_t_D_a_t_a resource is set to the index of the item in the list. <_A_p_p_l_y _B_u_t_t_o_n _A_c_t_i_v_a_t_e_d>: Initiates a directory and file search. Calls the _X_m_N_a_p_p_l_y_C_a_l_l_b_a_c_k callbacks with reason _X_m_C_R__A_P_P_L_Y. <_O_K _B_u_t_t_o_n _A_c_t_i_v_a_t_e_d>: If _X_m_N_m_u_s_t_M_a_t_c_h is True and the selection text does not match an item in the file list, calls the _X_m_N_n_o_M_a_t_c_h_C_a_l_l_b_a_c_k callbacks with reason _X_m_C_R__N_O__M_A_T_C_H. Otherwise, calls the _X_m_N_o_k_C_a_l_l_b_a_c_k callbacks with reason _X_m_C_R__O_K. Page 17 (printed 11/11/03) XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))) <_C_a_n_c_e_l _B_u_t_t_o_n _A_c_t_i_v_a_t_e_d>: Calls the _X_m_N_c_a_n_c_e_l_C_a_l_l_b_a_c_k callbacks with reason _X_m_C_R__C_A_N_C_E_L. <_H_e_l_p _B_u_t_t_o_n _A_c_t_i_v_a_t_e_d>: Calls the _X_m_N_h_e_l_p_C_a_l_l_b_a_c_k callbacks with reason _X_m_C_R__H_E_L_P. <_K_A_c_t_i_v_a_t_e>: If no button, list widget, or text widget has the keyboard focus: If _X_m_N_m_u_s_t_M_a_t_c_h is True and the selection text does not match an item in the file list, calls the _X_m_N_n_o_M_a_t_c_h_C_a_l_l_b_a_c_k callbacks with reason _X_m_C_R__N_O__M_A_T_C_H. Otherwise, calls the _X_m_N_o_k_C_a_l_l_b_a_c_k callbacks with reason _X_m_C_R__O_K. VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss The bindings for virtual keys are vendor specific. For information about bindings for virtual buttons and keys, see _V_i_r_t_u_a_l_B_i_n_d_i_n_g_s(_3_X). RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN _C_o_m_p_o_s_i_t_e(_3_X), _C_o_n_s_t_r_a_i_n_t(_3_X), _C_o_r_e(_3_X), _X_m_B_u_l_l_e_t_i_n_B_o_a_r_d(_3_X), _X_m_C_r_e_a_t_e_F_i_l_e_S_e_l_e_c_t_i_o_n_B_o_x(_3_X), _X_m_C_r_e_a_t_e_F_i_l_e_S_e_l_e_c_t_i_o_n_D_i_a_l_o_g(_3_X), _X_m_F_i_l_e_S_e_l_e_c_t_i_o_n_B_o_x_G_e_t_C_h_i_l_d(_3_X), _X_m_F_i_l_e_S_e_l_e_c_t_i_o_n_D_o_S_e_a_r_c_h(_3_X), _X_m_M_a_n_a_g_e_r(_3_X), and _X_m_S_e_l_e_c_t_i_o_n_B_o_x(_3_X). Page 18 (printed 11/11/03)